home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1994 October / macformat-005.iso / Shareware City / AfterDark / SS Installer / About Screen Saver QuicKeys next >
Encoding:
Text File  |  1994-07-03  |  3.8 KB  |  154 lines  |  [ttro/ttxt]
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9. What are they?
  10.  
  11. The Screen Saver QuicKeys are three QuicKeys™ extensions which communicate between QuicKeys and After Dark™ (and other screen savers which follow the Gestalt interface instituted by Berkeley Systems). They allow QuicKeys to control the screen saver and test the state the screen saver is in (asleep, awake, etc), doing a decision or jump on the outcome.
  12.  
  13. How to Install
  14.  
  15. Simply double-click the Installer Script icon that is in the same folder as this document. The QuicKeys Shortcut Installer will do the rest.
  16.  
  17. Requirements
  18.  
  19. The Screen Saver Quickeys need QuicKeys 3.0 or better and System 6.0.5 or better. 
  20.  
  21. They can work with After Dark 2.0u or better, but certain features (enabling and disabling After Dark and testing for sound and SystemIQ™) require After Dark 2.0x or better (or its derivatives such as Star Trek The Screen Saver™).
  22.  
  23. Many other screen savers, including Basic Black and DarkSide of the Macintosh, use the same Gestalt interface as After Dark, so most functions of Screen Saver QuicKeys should work with them too. I have not tested this, however.
  24.  
  25.  
  26. Screen Saver Control 
  27.  
  28.  
  29. Use this extension to control the screen saver:
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51. Balloon help is provided, not that you need it, I hope.
  52. If the command is impossible for some reason (eg no screen saver was installed or you tried to wake up a password-protected screen saver), the shortcut will do nothing.
  53.  
  54.  
  55. Screen Saver Decision 
  56.  
  57.  
  58. This is just like the standard Decision extension:
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80. Not every test is supported by every screen saver. In such cases (also when there is no screen saver installed), the screen saver is deemed to be the relevant one of: uninstalled; disabled; awake; unlocked; silent; or ignoring the SystemIQ.
  81.  
  82.  
  83. Screen Saver Jump 
  84.  
  85.  
  86. This is just like the standard Jump extension:
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108. The same rules as above apply for tests which are not supported by the screen saver. Be aware that a sequence will generally wake the screen saver initially, so the “Is Asleep” test is unlikely to cause a jump.
  109. NB: There is a slight possibility that a future version of QuicKeys may change the way it handles sequences, in which case this extension may no longer work. I make no commitment to update the extension should this happen. 
  110.  
  111.  
  112. Scripting
  113.  
  114. All three extensions are fully scriptable. The syntax is as follows:
  115.  
  116. ScreenSaverControl [Wake|Sleep|Enable|Disable]
  117.  
  118. ScreenSaverDecision        [ [Installed|NotInstalled] 
  119.                                                                                         | [Enabled|Disabled] 
  120.                                                                                         | [Asleep|Awake] 
  121.                                                                                         | [Locked|Unlocked] 
  122.                                                                                         | [UsingSound|Silent] 
  123.                                                                                         | [UsesSysIQ|IgnoresSysIQ] ]
  124.                                                                           {True_Shortcut "shortcut name"}
  125.                     {False_Shortcut "shortcut name"}
  126.  
  127. ScreenSaverJump                        [ [Installed|NotInstalled] 
  128.                                                                                         | [Enabled|Disabled] 
  129.                                                                                         | [Asleep|Awake] 
  130.                                                                                         | [Locked|Unlocked] 
  131.                                                                                         | [UsingSound|Silent] 
  132.                                                                                         | [UsesSysIQ|IgnoresSysIQ] ]
  133.                                                                                 Steps ##
  134.  
  135.  
  136. Fine Print
  137.  
  138. Screen Saver QuicKeys is postcardware. Non-commercial distribution is encouraged, but please only distribute the original compressed archive so that all the files stay together. Commercial distribution requires my express written permission. 
  139.  
  140. If you like the QuicKeys, send me a postcard at:
  141.  
  142.         230 Wandsworth Bridge Road,
  143.         London,
  144.         United Kingdom.
  145.         SW6 2UD.
  146.  
  147. Or send me email if you prefer.
  148.  
  149. Screen Saver QuicKeys is distributed as is in the hope it may be useful. I believe it to be safe, but you are warned that I wrote all three extensions in about twelve hours and I accept no resonsibility for any loss or damage caused by their use. So if it trashes your hard disk and you lose $1,000,000 worth of unbacked-up data, that's your problem.
  150.  
  151. ©1994 Richard Buckle.
  152. richardb@cocytus.demon.co.uk
  153. richardb@cix.compulink.co.uk
  154.